home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / fp067.zip / F-PROBE.DOC < prev    next >
Text File  |  1992-06-03  |  30KB  |  675 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                      F-Probe
  12.                                 version 0.67 Beta
  13.  
  14.                           Automated Upload File Testing
  15.                               for use with PCBoard
  16.  
  17.  
  18.  
  19.                        COPYRIGHT 1992 (c) ROBERT D. FELDMAN
  20.                                ALL RIGHTS RESERVED
  21.  
  22.  
  23.  
  24.  
  25.                                     3 June 1992
  26.                               First Beta-test release
  27.  
  28.  
  29.                             Author: Robert D. Feldman
  30.                              3941 South 700 West #22
  31.                             Salt Lake City, UT  84123
  32.  
  33.  
  34.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 2
  35.  
  36.  
  37.  
  38.  
  39.                                DISCLAIMER OF WARRANTY
  40.  
  41.  
  42.           ALTHOUGH CONSIDERABLE EFFORT WAS EXPENDED TO INSURE THAT THIS 
  43.           PRODUCT WORKS PROPERLY, IT MAY NOT WORK UNDER CERTAIN CONDITIONS.
  44.           BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  45.           WHICH THIS PROGRAM MAY BE INSTALLED, NO WARRANTY OF FITNESS FOR
  46.           A PARTICULAR PURPOSE IS OFFERED.  THIS SOFTWARE AND MANUAL ARE
  47.           OFFERED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF
  48.           MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR
  49.           IMPLIED.  
  50.  
  51.           THE AUTHOR (ROBERT D. FELDMAN) WILL NOT BE LIABLE FOR ANY
  52.           DAMAGES OR LOSSES OF ANY KIND, TO ANY PERSON OR ENTITY, WHICH
  53.           MIGHT OCCUR FROM THE ABILITY OR INABILITY TO USE THIS SOFTWARE. 
  54.           YOU USE THIS SOFTWARE ENTIRELY AT YOUR OWN RISK.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                   COPYRIGHT NOTICES
  62.  
  63.           PCBOARD is a registered trademark of Clark Development 
  64.                   Company, Inc.
  65.           SENDCOM.EXE by Bill Shields is in the public domain.
  66.           MS-DOS is a registered trademark of MicroSoft Corp.
  67.           PKZIP and PKUNZIP are copyright by PKWare, Inc.
  68.           SCAN (Viruscan) is copyright by McAfee Associates.
  69.           DesqView and QEMM are copyright by Quarterdeck.
  70.  
  71.  
  72.  
  73.                                        SENDCOM
  74.  
  75.                The archive SENDCOM2.ZIP in its original form is included
  76.           in this package.  The author claims no rights, credit or responsi-
  77.           bility for the Sendcom software.  Sendcom was created and released
  78.           into the Public Domain by Bill Shields.  Read sendcom.doc for
  79.           further details.  I have Mr. Shields permission to include
  80.           Sendcom with this package.
  81.  
  82.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 3
  83.  
  84.  
  85.  
  86.                                  DISTRIBUTION POLICY
  87.  
  88.                 This distribution policy applies to version 0.67ß of F-Probe
  89.           ONLY. This version is released as FREEWARE.  A registration fee
  90.           for this version of F-Probe is not required.  However, if you find
  91.           this software useful and wish to express your gratitude in mone-
  92.           tary terms, the author will accept any donations sent to the
  93.           address below.  A donation of $10 is suggested.  Monetary donations
  94.           will also serve to encourage and motivate the author to pursue
  95.           further development of F-Probe and other programming projects.  
  96.  
  97.                Future enhanced versions of F-Probe may require registration
  98.           governed by an updated distribution policy.  This means that you
  99.           may use, copy and distribute F-Probe version 0.67ß provided that
  100.           the letter and intent of this distribution policy are strictly
  101.           adhered to.  
  102.  
  103.                All files contained in the original F-Probe archive must be
  104.           distributed without modification of any kind and only the original
  105.           files will be included in the archive.  
  106.  
  107.                This software may not be distributed for profit by anyone
  108.           other than the author.  The only exception is the nominal fee
  109.           which shareware distributors use to cover duplication and distri-
  110.           bution costs, not to exceed $7 under any circumstances.  The
  111.           author reserves all rights to the F-Probe software and accompany-
  112.           ing documentation.  Deviation from this policy constitutes copy-
  113.           right infringement.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                          COMMENTS, SUGGESTIONS AND DONATIONS
  120.  
  121.                              Send them to the Author:
  122.  
  123.                              Robert D. Feldman
  124.                              3941 South 700 West #22
  125.                              Salt Lake City, UT  84123
  126.  
  127.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 4
  128.  
  129.  
  130.                                     INTRODUCTION
  131.  
  132.                The requirements of our BBS were simple: We needed a program
  133.           that was easy to set up, checked uploads for Zip file integrity,
  134.           checked for viruses, required little memory space and was
  135.           configurable.  That was all.  Anything else was "bells and
  136.           whistles".  Our primary concern was reliability.  
  137.  
  138.                 F-Probe operation is simple.  All F-Probe commands are
  139.           executed by F-PROBE.EXE and PCBTEST.BAT.  Pcbtest calls F-Probe
  140.           into action.  Then, F-Probe verifies that the uploaded file is in
  141.           fact a ZIP-compressed file.  If the file isn't zipped, the file
  142.           is renamed with the extender .!!N (for "N"ot a ZIP file) and 
  143.           F-Probe halts operation.  Note that this version of F-Probe
  144.           only checks for ZIP files.  Later versions will check other
  145.           file compression formats. It is the Sysop's responsibility to
  146.           manually check all non-zipped files.
  147.  
  148.                 If the file is verified as a ZIP file, it is tested for 
  149.           integrity.  If the integrity test fails, the file is renamed .!!Z 
  150.           (for "Z"ip integrity error) and F-Probe stops.  If the integrity 
  151.           test is passed, the contents of the archive are dumped into the 
  152.           WORK directory and searched for embedded ZIP files.  If any are 
  153.           found, they are tested and dumped also.  If any embedded ZIP files
  154.           fail verification or the integrity test, the upload file is renamed
  155.           with the extender .!!Z and F-Probe stops.
  156.  
  157.                 If the sysop indicated during installation that a file-date
  158.           check was desired, F-Probe next performs that test.  If the upload
  159.           fails the file-date test, it is renamed with the extender .!!D
  160.           (for "D"ate error) and F-Probe stops.
  161.  
  162.                 Next, F-Probe calls McAfee's SCAN to check all files in the
  163.           WORK directory for viruses. If one is detected, the upload file is
  164.           renamed with the extender .!!V (for "V"irus) and F-Probe stops.
  165.  
  166.                 If all previous tests are successful, the upload filename
  167.           remains intact and no further processing is performed.  A one-line
  168.           result message will be appended to the upload description (if the
  169.           sysop requested this option during installation).  If any of the
  170.           tests failed, PCBTEST.BAT continues the processing by disposing of
  171.           renamed upload files in the manner specified by the sysop when
  172.           F-Probe was installed (several options are available).
  173.  
  174.                 This version of F-Probe is fully functional.  No features
  175.           are crippled and you are not exposed to nagging reminders to pay
  176.           up. This is my small way of reciprocating to the many Sysops
  177.           whose hospitality has made my tele-computing so much more
  178.           enjoyable.
  179.  
  180.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 5
  181.  
  182.  
  183.  
  184.  
  185.                               FEATURES OF F-PROBE 0.67ß
  186.  
  187.           ■    Calls PKunzip to test upload for ZIP file integrity
  188.                errors.  Tested with PKunzip version 1.1.
  189.  
  190.           ■    Calls Scan to check archived files for viruses.
  191.                Tested with Scan versions 89 and 91.
  192.  
  193.           ■    Low memory requirements.  Small and compact.
  194.                Since the memory requirements of PKunzip and Scan
  195.                are likely to grow, I intentionally let
  196.                PCBTEST.BAT do as much work as possible after
  197.                F-Probe runs in order to keep F-Probe memory-
  198.                thrifty.  F-Probe requires only 64K when running.  
  199.  
  200.           ■    All command-line parameters available to Scan.exe are
  201.                accessible.
  202.  
  203.           ■    Highly configurable.
  204.  
  205.           ■    Recursive search through unlimited levels of embedded
  206.                zip files.
  207.  
  208.           ■    Displays status messages to BBS caller while in operation.
  209.  
  210.           ■    Optionally appends a one-line, test-result message to
  211.                the file description in the upload directory listing.
  212.  
  213.           ■    Optionally tests files in upload for file date-stamp
  214.                constraints.
  215.  
  216.           ■    Great flexibility in disposing of suspect upload files.
  217.  
  218.           ■    Although F-Probe was designed specifically for use on PCBoard
  219.                BBSes, it could be used as a stand-alone application or on
  220.                other BBS systems.  You'll need to experiment.
  221.  
  222.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 6
  223.  
  224.  
  225.  
  226.  
  227.                                   INSTALLATION
  228.  
  229.           Installing F-Probe on your system consists of four, easy steps:
  230.  
  231.  
  232.           INSTALLATION STEP 1. Create Directories.
  233.  
  234.                You will need to use the DOS command (MKDIR or MD) to create
  235.           three sub-directories.  The first sub-directory should be on the
  236.           same drive as your C:\PCB directory and should be in the root
  237.           directory.  You may call it anything you like, but I suggest the
  238.           name F-PROBE.  The other two sub-directories should be created
  239.           within the F-PROBE directory, and should be named WORK and
  240.           BADFILES.  Here are the suggested lines to enter in order to
  241.           create these three sub-directories.  Be sure to change the
  242.           drive-letter if you are using a different drive:
  243.  
  244.                MD C:\F-PROBE
  245.                MD C:\F-PROBE\WORK
  246.                MD C:\F-PROBE\BADFILES
  247.  
  248.                The sample PCBTEST.BAT and F-PROBE.CFG files found in the
  249.           F-Probe archive package, and the remaining installation
  250.           instructions here, will assume that the directories you create for
  251.           F-Probe are named C:\F-PROBE, C:\F-PROBE\WORK, and
  252.           C:\F-PROBE\BADFILES. It is also assumed that your main PCBoard
  253.           directory (where PCBTEST.BAT is) is named C:\PCB and that the
  254.           work directory for the logged on user is C:\PCB for single-node
  255.           boards and C:\PCB\NODE%PCBNODE% for multi-node boards.  I
  256.           recommend that you follow this naming convention.  If you choose
  257.           to substitute the C:\F-PROBE and C:\PCB paths, be sure to make
  258.           the appropriate changes to this documentation manual.  The
  259.           subdirectory WORK (within F-PROBE) must be named as such since
  260.           that name is hard-coded within F-Probe.
  261.  
  262.                The C:\F-PROBE directory will hold all the F-Probe program
  263.           and support files.  The C:\F-PROBE\WORK directory is a temporary
  264.           work area.  This directory is always empty, except when F-Probe
  265.           is checking files.  The C:\F-PROBE\BADFILES is the directory
  266.           where suspect uploaded files can optionally be stored.
  267.  
  268.  
  269.  
  270.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 7
  271.  
  272.  
  273.           INSTALLATION STEP 2. Extract and copy F-Probe files to proper
  274.                                sub-directories.
  275.  
  276.           a.    Extract all files contained in the F-Probe archive into the
  277.                 C:\F-PROBE subdirectory.
  278.  
  279.           b.    Extract all files contained in C:\F-PROBE\SENDCOM2.ZIP (this
  280.                 file came from the F-Probe archive package) into C:\F-PROBE.
  281.  
  282.           c.    In your C:\PCB subdirectory, rename your current PCBTEST.BAT
  283.                 to PCBTEST.OLD in case you ever discontinue use of F-Probe
  284.                 and wish to return to your old setup.
  285.  
  286.           d.    Copy C:\F-PROBE\PCBTEST.BAT (sample file which came from
  287.                 the F-Probe archive package) to C:\PCB.
  288.           
  289.           
  290.                 After installation step 2 is completed, your C:\F-PROBE
  291.           directory should contain the following files:
  292.           
  293.                 Filename         Description
  294.                 ------------     -----------------------------------------
  295.                 F-PROBE.EXE      Main Executable program.
  296.                 F-PROBE.CFG      Configuration file.
  297.                 F-PROBE.DOC      The file you are reading now.
  298.                 SENDCOM2.ZIP     Sendcom archive in its
  299.                                  original form.
  300.                 SENDCOM.EXE      Sendcom program.
  301.                 SENDCOM.DOC      Documentation for Sendcom.
  302.                 PCBTEST.BAT      PCBoard batch file configured
  303.                                  for F-Probe operation.
  304.                 FILE_ID.DIZ      Brief description of F-Probe.
  305.                 SAMPLE.MSG       Examples of screen and file output.
  306.           
  307.                 After F-Probe's first execution, additional files are
  308.           automatically created and updated by F-Probe in C:\F-PROBE:
  309.           
  310.                 Filename         Description
  311.                 -----------      --------------------------------------
  312.                 F-PROBE.LOG      Log file where all F-Probe
  313.                                  activity is recorded.
  314.                 F-PROBE.RES      Single-line results message
  315.                                  for appending to upload
  316.                                  directory listing.
  317.                 F-PROBE.DES      Holds contents of uploaded file's
  318.                                  description.
  319.                 F-PROBE.VIR      Output from SCAN execution.
  320.  
  321.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 8
  322.           
  323.           INSTALLATION STEP 3.  Edit the F-Probe configuration file
  324.                                 (C:\F-PROBE\F-PROBE.CFG).
  325.           
  326.                 The F-PROBE.CFG file contains a remarks line, followed
  327.           by a configuration item line, followed by more remarks and
  328.           configuration lines.  After the last configuration line, there
  329.           is a line with the word NOTES on it.  You may add optional
  330.           remarks following the NOTES line to remind you of configuration
  331.           item details.  If the filenames in the configuration items need
  332.           modification, simply overwrite the present configuration entry
  333.           with a new one.
  334.           
  335.                 DO NOT add any configuration or remarks lines above the
  336.           NOTES line.  DO NOT modify the text in the remarks lines.  DO NOT
  337.           change the sequence in which the lines are arranged.  
  338.           
  339.                 An explanation of the different configuration items follows.
  340.           Each configuration line is listed in the rectangle exactly as it
  341.           appears in the sample configuration file (C:\F-PROBE\F-PROBE.CFG).
  342.           Then the line is explained so you can make needed modifications:
  343.           
  344.           
  345.           
  346.           ┌──────────────────────────────────────────────────────────────┐
  347.           │ ----------PATH WHERE F-PROBE.EXE IS INSTALLED:---------------│
  348.           │ C:\F-PROBE                                                   │
  349.           └──────────────────────────────────────────────────────────────┘
  350.  
  351.                 Self-explanatory.
  352.  
  353.  
  354.  
  355.           ┌───────────────────────────────────────────────────────────────┐
  356.           │ ----------PATH WHERE PKUNZIP.EXE IS INSTALLED:----------------│
  357.           │ C:\UTIL                                                       │
  358.           └───────────────────────────────────────────────────────────────┘
  359.  
  360.                 Pkunzip.exe is not included with this F-Probe package but
  361.                 can be obtained on most BBSes.  You obviously have a copy
  362.                 of Pkunzip or you would have been unable to extract this
  363.                 documentation manual <grin>.
  364.  
  365.  
  366.  
  367.           ┌───────────────────────────────────────────────────────────────┐
  368.           │ ----------PATH WHERE SCAN.EXE IS INSTALLED:-------------------│
  369.           │ C:\UTIL                                                       │
  370.           └───────────────────────────────────────────────────────────────┘
  371.  
  372.                F-Probe.CFG assumes that you will use McAfee's Scan program
  373.                to test for viruses.  Scan.exe is not included with
  374.                this F-Probe package but can be obtained on many BBSes.
  375.  
  376.  
  377.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 9
  378.  
  379.  
  380.  
  381.  
  382.           ┌───────────────────────────────────────────────────────────────┐
  383.           │ ----------PARAMETER LIST TO PASS TO SCAN.EXE------------------│
  384.           │ /a /nomem /fast /nopause                                      │
  385.           └───────────────────────────────────────────────────────────────┘
  386.  
  387.                These parameters are set for McAfee's virus scan and are
  388.                the ones I recommend.  Refer to Scan documentation for
  389.                details if you want to use different parameters.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.           ┌───────────────────────────────────────────────────────────────┐
  396.           │ ----------DATE CHECKING ACCEPTABLE YEAR LOWER LIMIT:----------│
  397.           │ 1991                                                          │
  398.           │ ----------DATE CHECKING ACCEPTABLE MONTH LOWER LIMIT(1-12): --│
  399.           │ 7                                                             │
  400.           └───────────────────────────────────────────────────────────────┘
  401.  
  402.                These two configuration items determine which uploads will
  403.                fail the file date-stamp test. If the most recent file in an
  404.                archive is dated earlier than the month/year you specify
  405.                here, the upload fails the test and the archive filename
  406.                extender is renamed to .!!D.  The purpose of this extender
  407.                is to "mark" the file for later processing.  To disable date
  408.                checking, enter a single zero (0) for both the year and the
  409.                month lower limits.
  410.  
  411.  
  412.  
  413.  
  414.  
  415.           ┌───────────────────────────────────────────────────────────────┐
  416.           │≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡ │
  417.           │ NOTES                                                         │
  418.           └───────────────────────────────────────────────────────────────┘
  419.  
  420.                You may add as many remarks as you wish to the lines
  421.                following the word NOTES.
  422.  
  423.  
  424.  
  425.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 10
  426.  
  427.  
  428.           INSTALLATION STEP 4. Edit C:\PCB\PCBTEST.BAT file.
  429.  
  430.  
  431.                An explanation of the lines in PCBTEST.BAT follows.
  432.           Edit your file where necessary to correspond to your drive letter
  433.           and subdirectory names.  (Refer to the sample PCBTEST.BAT which
  434.           you copied into your C:\PCB subdirectory.):
  435.  
  436.  
  437.  
  438.  
  439.           ┌───────────────────────────────────────────────────────────────┐
  440.           │ C:\F-PROBE\F-PROBE  C:\F-PROBE.CFG  %1                        │ 
  441.           └───────────────────────────────────────────────────────────────┘
  442.                                                                       
  443.                This entry is required. It executes F-Probe.  The variable
  444.                (%1) refers to the uploaded filename -- do not edit this
  445.                part of the line.
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.           ┌───────────────────────────────────────────────────────────────┐
  453.           │ COPY  %3+C:\F-PROBE\F-PROBE.RES  C:\F-PROBE\F-PROBE.DES       │
  454.           │ COPY  C:\F-PROBE\F-PROBE.DES  %3                              │
  455.           └───────────────────────────────────────────────────────────────┘
  456.  
  457.                These two lines are optional.  They append a one-line
  458.                test result message to the file description in the upload
  459.                directory listing.  The variable (%3) refers to the file
  460.                description entered by the caller (or to the description
  461.                contained in FILE_ID.DIZ if it exists) -- do not edit
  462.                this part of the line.  Green messages are displayed for
  463.                uploads which passed all tests; red messages, for failed
  464.                tests.  Replace the paths, if necessary.  DO NOT modify
  465.                anything else.  To disable this feature, simply delete
  466.                these two lines from the batch file.
  467.  
  468.  
  469.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 11
  470.  
  471.  
  472.  
  473.               «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»
  474.               «∙»∙«∙» CAUTION «∙»∙«∙» CAUTION «∙»∙«∙» CAUTION «∙»∙«∙»
  475.               «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»
  476.  
  477.                    PLEASE PAY CLOSE ATTENTION TO THE FOLLOWING
  478.                    INSTRUCTIONS BECAUSE AN ERROR HERE COULD
  479.                    PROVE DISASTROUS!!.                                  
  480.  
  481.  
  482.  
  483.           ┌───────────────────────────────────────────────────────────────┐
  484.           │ CD  C:\PCB\FILES\UPLOADS                                      │
  485.           │ IF EXIST  *.!!?  COPY  *.!!?  C:\F-PROBE\BADFILES             │
  486.           │ IF EXIST  *.!!?  DEL  *.!!?                                   │
  487.           │ CD  C:\PCB\FILES\PRIVUL                                       │
  488.           │ IF EXIST  *.!!?  COPY  *.!!?  C:\F-PROBE\BADFILES             │
  489.           │ IF EXIST  *.!!?  DEL  *.!!?                                   │
  490.           │ CD  C:\PCB\NODE%PCBNODE%                                      │
  491.           └───────────────────────────────────────────────────────────────┘
  492.  
  493.                These entries are optional.  However, they offer a powerful
  494.                tool for segregating and/or disposing of files which
  495.                failed any or all of the tests.
  496.  
  497.                The command lines listed above are grouped in "clusters"
  498.                of three command lines.  Each cluster consists of one 'cd'
  499.                and two 'if exist' command lines.  YOU NEED TO SET UP ONE
  500.                CLUSTER OF THREE LINES FOR EACH UPLOAD DIRECTORY AVAILABLE
  501.                ON YOUR BBS.  In the example above, the BBS has two upload
  502.                directories, one public:  C:\PCB\FILES\UPLOADS, and one
  503.                private (for sysop only): C:\PCB\FILES\PRIVUL.
  504.  
  505.               The first line in a cluster:    
  506.                     CD C:\PCB\FILES\UPLOAD  
  507.               changes the default directory to the upload directory. 
  508.  
  509.               The second line in a cluster:
  510.                     IF EXIST *.!!? COPY *.!!? C:\F-PROBE\BADFILES
  511.               searches the upload directory for any files which have
  512.               been renamed as a result of failing one of the F-Probe
  513.               tests.  These are the renaming conventions:
  514.  
  515.               Filename Extender             Reason for renaming
  516.               ---------------------------------------------------------
  517.                   .!!D                 Failed file date-stamp test.
  518.                   .!!Z                 Failed Zip integrity test.
  519.                   .!!V                 One or more viruses were found
  520.                                              in archived files.
  521.                   .!!N                 Non-ZIP file, check manually.
  522.  
  523.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 12
  524.  
  525.  
  526.                In the above example, we search for files which have failed
  527.                ANY test. If any files are found, they are copied to a
  528.                temporary holding directory (C:\F-PROBE\BADFILES).  At this
  529.                point, there is room for sysop creativity.  You may elect to:
  530.      
  531.                     a. Copy none of the suspect file types.  Simply
  532.                        delete this line from the cluster.
  533.      
  534.                     b. Copy only one group of suspect files.  Simply
  535.                        replace the .!!? extender with the one you are
  536.                        interested in (.!!V, .!!D, .!!N, or .!!Z).
  537.      
  538.                     c. Copy two, three or all four types of files to a
  539.                        corresponding directory. For instance, copy .!!Z
  540.                        to a directory named C:\F-PROBE\BADZIP, .!!D to a
  541.                        directory named C:\F-PROBE\BADDATE, .!!N to a
  542.                        directory named C:\F-PROBE\NONZIP, and .!!V to a
  543.                        directory named C:\F-PROBE\VIRII.  Simply customize
  544.                        the line as in (b) above, create one or more addi-
  545.                        tional lines and customize them.  This would expand
  546.                        the number of lines in this particular cluster to up
  547.                        to 6 lines.  Be sure to create these customized
  548.                        directories first.  For example, the cluster might
  549.                        be customized to read:
  550.      
  551.                            CD C:\PCB\FILES\PRIVUL 
  552.                            IF EXIST  *.!!Z  COPY  *.!!Z  C:\F-PROBE\BADZIP
  553.                            IF EXIST  *.!!D  COPY  *.!!D  C:\F-PROBE\BADDATE
  554.                            IF EXIST  *.!!N  COPY  *.!!N  C:\F-PROBE\NONZIP
  555.                            IF EXIST  *.!!V  COPY  *.!!V  C:\F-PROBE\VIRII
  556.                            IF EXIST  *.!!?  DEL  *.!!?
  557.      
  558.      
  559.      
  560.                The last line in a cluster:
  561.                     IF EXIST  *.!!?  DEL  *.!!?
  562.                deletes any renamed files from the upload directory.  This
  563.                command line, in conjunction with the previous ones, simulate
  564.                the act of "moving" files to their respective directories.
  565.                If you do not wish to "move" suspect files, but only want to
  566.                delete them, remove all the 'if exist... copy...' lines from
  567.                the cluster.
  568.      
  569.                If you do not want to "move" or delete the suspect files from
  570.                the upload directory, simply remove all cluster lines from
  571.                the PCBTEST.BAT file.
  572.      
  573.      
  574.  
  575.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 13
  576.  
  577.  
  578.  
  579.                The last line of PCBTEST.BAT (after all of the three-line
  580.                clusters for each upload directory on your BBS):
  581.                     CD  C:\PCB\NODE%PCBNODE%
  582.                restores the default directory to the one in effect before
  583.                F-Probe was executed.  This must be the directory designated
  584.                by PCBoard for the presently logged on remote user.  This
  585.                line is required only if you copied or deleted marked files
  586.                in the upload directories.  Of course, if you have a single-
  587.                node BBS, the line should be:    CD  C:\PCB
  588.      
  589.                  
  590.                This is the end of the four steps required to install F-Probe
  591.           on your BBS.  If any of these instructions aren't clear or if you
  592.           have configuration questions, you can contact the author at his
  593.           home address (given on the cover page) or by leaving a message to
  594.           BOB FELDMAN on the USOE BBS  (801) 538-7973.
  595.             
  596.  
  597.                
  598.  
  599.  
  600.                                      F-PROBE.LOG
  601.  
  602.                The F-PROBE.LOG file is created by F-Probe when it runs, if
  603.           the log file doesn't already exist.  F-Probe updates F-PROBE.LOG,
  604.           if it does exist.  This file keeps a record of all F-Probe activ-
  605.           ities and testing results.  You should browse through it and
  606.           purge it routinely.
  607.  
  608.  
  609.  
  610.  
  611.                                    TROUBLESHOOTING
  612.  
  613.                Most of the problems you might encounter while installing
  614.           and operating F-Probe are likely to occur because F-Probe is
  615.           unable to locate a misplaced file.  Double-check the F-PROBE.CFG
  616.           and PCBTEST.BAT files for accuracy of the specified paths.
  617.  
  618.                During Alpha-testing, I encountered a problem when the BBS
  619.           sysop tried to print when the system printer was offline (off).
  620.           Due to this, messages no longer appeared on the remote user's
  621.           screen.  Unlock the node, and F-Probe will echo messages again.
  622.  
  623.  
  624.           F-Probe «∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙»∙«∙» Page 14
  625.  
  626.  
  627.  
  628.                                     ALPHA-TESTING
  629.  
  630.                Initial alpha-testing of this software was performed on a
  631.           386/25 Epson Computer running 3 nodes on PCBoard version 14.5a.
  632.           Operating System MS-DOS 5.0.  DesqView 2.42 and QEMM 6.02.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.                                  A SPECIAL THANK YOU
  639.  
  640.                 I would like to express my appreciation to Jolene Morris
  641.           for her help in writing this documentation file and in letting
  642.           me use the Utah State Office of Education's BBS to alpha test
  643.           F-Probe.
  644.  
  645.  
  646.  
  647.  
  648.                                         NEXT?
  649.  
  650.                In the next version of F-Probe, I hope to be able to
  651.           incorporate the following enhanced features:
  652.  
  653.           ■     A fully automatic installation utility.
  654.  
  655.           ■     Improved output to remote user screen.
  656.  
  657.           ■     Support for other archiver formats.
  658.  
  659.           ■     Mass checking of BBS downloads, even those on CD-ROM.
  660.  
  661.  
  662.  
  663.                                CHANGE HISTORY
  664.  
  665.         Release Date   Version              Changes/Fixes
  666.         -----------------------------------------------------------------
  667.         31 May 1992    0.66ß    First Public Release.
  668.  
  669.          3 Jun 1992    0.67ß    Fixed a reported bug which prevented sysops
  670.                                 from using F-probe on a "local" node.
  671.                                 Improved error reporting.  To upgrade from
  672.                                 version 0.66, simply replace the old
  673.                                 F-PROBE.EXE with the new one.
  674.  
  675.